/*
 * Copyright (c) 1994, 2005, Oracle and/or its affiliates. All rights reserved.
 * ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */

package java.util;

/**
 * 实现Enumeration接口的对象每次生成一个元素。对nextElement方法的连续调用将返回该系列的连续元素。
 * 
 * <p>例如，要打印一个Vector v的所有元素:
 *
 * <pre>
 *   for (Enumeration&lt;E&gt; e = v.elements(); e.hasMoreElements();)
 *       System.out.println(e.nextElement());</pre>
 * <p>
 * 方法用于枚举vector的元素、hashtable的key和value。
 * Enumerations还用于指定SequenceInputStream的输入流。
 * 
 * <p>
 * 注意:这个接口的功能是被Iterator接口复制的。
 * 此外，Iterator添加了一个可选的删除操作，并且具有更短的方法名。
 * 新的实现应该考虑使用迭代器而不是枚举。
 *
 * @see     java.util.Iterator
 * @see     java.io.SequenceInputStream
 * @see     java.util.Enumeration#nextElement()
 * @see     java.util.Hashtable
 * @see     java.util.Hashtable#elements()
 * @see     java.util.Hashtable#keys()
 * @see     java.util.Vector
 * @see     java.util.Vector#elements()
 *
 * @author  Lee Boynton
 * @since   JDK1.0
 */
public interface Enumeration<E> {
    /**
     * 测试此枚举是否包含更多元素。
     *
     * @return  <code>true</code> if and only if this enumeration object
     *           contains at least one more element to provide;
     *          <code>false</code> otherwise.
     */
    boolean hasMoreElements();

    /**
     * 如果此枚举对象至少还能提供一个元素，则返回此枚举的下一个元素。
     *
     * @return     the next element of this enumeration.
     * @exception  NoSuchElementException  if no more elements exist.
     */
    E nextElement();
}
